home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / shpdeallc.z / shpdeallc
Encoding:
Text File  |  2002-10-03  |  2.5 KB  |  39 lines
  1.  
  2. SHPDEALLC(3F)                                                 SHPDEALLC(3F)
  3.  
  4.  
  5. NNNNAAAAMMMMEEEE
  6.      SSSSHHHHPPPPDDDDEEEEAAAALLLLLLLLCCCC - Returns a memory block to the symmetric heap
  7.  
  8. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  9.      PPPPOOOOIIIINNNNTTTTEEEERRRR ((((_a_d_d_r,,,, AAAA((((1111))))))))
  10.      IIIINNNNTTTTEEEEGGGGEEEERRRR _e_r_r_c_o_d_e,,,, _a_b_o_r_t
  11.      CCCCAAAALLLLLLLL SSSSHHHHPPPPDDDDEEEEAAAALLLLLLLLCCCC((((_a_d_d_r,,,, _e_r_r_c_o_d_e,,,, _a_b_o_r_t))))
  12.  
  13. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  14.      SSSSHHHHPPPPDDDDEEEEAAAALLLLLLLLCCCC returns a block of memory (allocated using SSSSHHHHPPPPAAAALLLLLLLLOOOOCCCC) to the
  15.      list of available space in the symmetric heap.  To maintain symmetric
  16.      heap consistency, all processing elements (PEs) in a program must call
  17.      SSSSHHHHPPPPDDDDEEEEAAAALLLLLLLLCCCC with the same value of _a_d_d_r; if any PEs are missing, the
  18.      program hangs.
  19.  
  20.      The SSSSHHHHPPPPDDDDEEEEAAAALLLLLLLLCCCC function accepts the following arguments:
  21.  
  22.      AAAArrrrgggguuuummmmeeeennnntttt       DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  23.      _a_d_d_r           First word address of the block to deallocate (input).
  24.      _e_r_r_c_o_d_e        Error code is 0 if no error was detected; otherwise, it
  25.                     is a negative integer code for the type of error
  26.                     (output).
  27.      _a_b_o_r_t          Abort code.  Nonzero requests abort on error; 0
  28.                     requests an error code (input).
  29.  
  30.      Error conditions are as follows:
  31.  
  32.      CCCCooooddddeeee           CCCCoooonnnnddddiiiittttiiiioooonnnn
  33.      ----3333             Address is outside the bounds of the symmetric heap.
  34.      ----4444             Block is already free.
  35.      ----5555             Address is not at the beginning of the block.
  36.  
  37. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  38.      iiiinnnnttttrrrroooo____sssshhhhmmmmeeeemmmm(3), sssshhhhmmmmaaaalllllllloooocccc(3F), sssshhhhppppaaaalllllllloooocccc(3F), sssshhhhppppccccllllmmmmoooovvvveeee(3F)
  39.